package com.zzyl.common.core.domain;

import java.io.Serializable;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import com.fasterxml.jackson.annotation.*;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

/**
 * Entity基类 - 所有业务实体的通用父类
 *
 * 包含创建人、创建时间、更新人、更新时间、备注及扩展参数等公共字段
 *
 * @author ruoyi
 */
@ApiModel(value = "BaseEntity", description = "所有实体类的基类，封装了公共字段：创建/更新信息、备注和扩展参数")
public class BaseEntity implements Serializable {

    private static final long serialVersionUID = 1L;

    /**
     * 搜索值（前端传入的通用查询条件，不存数据库）
     */
    @ApiModelProperty(value = "搜索关键字，用于模糊查询（如列表页搜索框输入内容）",
            example = "基础护理",
            hidden = true) // 因被 @JsonIgnore 忽略序列化，设为 hidden
    @JsonIgnore
    @TableField(exist = false)
    private String searchValue;

    /**
     * 创建者
     */
    @ApiModelProperty(value = "记录创建者的用户名或ID",
            example = "admin",
            notes = "通常由系统自动填充当前登录用户")
    @TableField(fill = FieldFill.INSERT)
    private String createBy;

    /**
     * 创建时间
     */
    @ApiModelProperty(value = "记录创建的时间戳",
            example = "2025-04-05 10:30:00",
            notes = "格式：yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @TableField(fill = FieldFill.INSERT)
    private Date createTime;

    /**
     * 更新者
     */
    @ApiModelProperty(value = "最后修改该记录的用户",
            example = "zhangsan",
            notes = "编辑操作时自动更新为当前用户")
    @TableField(fill = FieldFill.UPDATE)
    private String updateBy;

    /**
     * 更新时间
     */
    @ApiModelProperty(value = "记录最后一次更新的时间戳",
            example = "2025-04-05 14:20:15",
            notes = "每次修改都会自动刷新此时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @TableField(fill = FieldFill.UPDATE)
    private Date updateTime;

    /**
     * 备注
     */
    @ApiModelProperty(value = "附加说明或备注信息",
            example = "此项目适用于术后康复护理",
            allowableValues = "nullable")
    private String remark;

    /**
     * 请求参数（非数据库字段，用于接收额外查询条件或页面参数）
     */
    @ApiModelProperty(value = "请求中的附加参数映射，可用于动态查询条件传递",
            notes = "Map结构，仅在需要时序列化输出（非空时才返回）",
            hidden = false)
    @JsonInclude(JsonInclude.Include.NON_EMPTY)
    @TableField(exist = false)
    private Map<String, Object> params;

    // ==================== Getter & Setter ====================

    public String getSearchValue() {
        return searchValue;
    }

    public void setSearchValue(String searchValue) {
        this.searchValue = searchValue;
    }

    public String getCreateBy() {
        return createBy;
    }

    public void setCreateBy(String createBy) {
        this.createBy = createBy;
    }

    public Date getCreateTime() {
        return createTime;
    }

    public void setCreateTime(Date createTime) {
        this.createTime = createTime;
    }

    public String getUpdateBy() {
        return updateBy;
    }

    public void setUpdateBy(String updateBy) {
        this.updateBy = updateBy;
    }

    public Date getUpdateTime() {
        return updateTime;
    }

    public void setUpdateTime(Date updateTime) {
        this.updateTime = updateTime;
    }

    public String getRemark() {
        return remark;
    }

    public void setRemark(String remark) {
        this.remark = remark;
    }

    public Map<String, Object> getParams() {
        if (params == null) {
            params = new HashMap<>();
        }
        return params;
    }

    public void setParams(Map<String, Object> params) {
        this.params = params;
    }
}
